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About Reference Pages 


The ULTRIX Reference Pages describe commands, system calls, routines, file 
formats, and special files for RISC and VAX platforms. 


Sections 

The reference pages are divided into eight sections according to topic. Within each 
section, the reference pages are organized alphabetically by title, except Section 3, 
which is divided into subsections. Each section and most subsections have an 
introductory reference page called intro that describes the organization and 
anything unique to that section. 

Some reference pages carry a one- to three-letter suffix after the section number, for 
example, scan(lmh). The suffix indicates that there is a “family” of reference 
pages for that utility or feature. The Section 3 subsections all use suffixes and other 
sections may also have suffixes. 

Following are the sections that make up the ULTRIX Reference Pages. 


Section 1: Commands 

This section describes commands that are available to all ULTRIX users. Section 1 is 
split between two binders. The first binder contains reference pages for titles that fall 
between A and L. The second binder contains reference pages for titles that fall 
between M and Z. 

Section 2: System Calls 

This section defines system calls (entries into the ULTRIX kernel) that are used by 
all programmers. The introduction to Section 2, intro(2), lists error numbers with 
brief descriptions of their meanings. The introduction also defines many of the terms 
used in this section. 

Section 3: Routines 

This section describes the routines available in ULTRIX libraries. Routines are 
sometimes referred to as subroutines or functions. 

Section 4: Special Files 

This section describes special files, related device driver functions, databases, and 
network support. 




Section 5: File Formats 

This section describes the format of system files and how the files are used. The files 
described include assembler and link editor output, system accounting, and file 
system formats. 

Section 6: Games 

The reference pages in this section describe the games that are available in the 
unsupported software subset. The reference pages for games are in the document 
Reference Pages for Unsupported Software. 

Section 7: Macro Packages and Conventions 

This section contains miscellaneous information, including ASCII character codes, 
mail addressing formats, text formatting macros, and a description of the root file 
system. 

Section 8: Maintenance 

This section describes commands for system operation and maintenance. 


Platform Labels 

The ULTRIX Reference Pages contain entries for both RISC and VAX platforms. 
Pages that have no platform label beside the title apply to both platforms. Reference 
pages that apply only to RISC platforms have a “RISC” label beside the title and the 
VAX-only reference pages that apply only to VAX platforms are likewise labeled 
with “VAX.” If each platform has the same command, system call, routine, file 
format, or special file, but functions differently on the different platforms, both 
reference pages are included, with the RISC page first. 


Reference Page Format 

Each reference page follows the same general format. Common to all reference pages 
is a title consisting of the name of a command or a descriptive title, followed by a 
section number; for example, date(l). This title is used throughout the 
documentation set. 


The headings in each reference page provide specific information. The standard 
headings are: 

Name Provides the name of the entry and gives a short description. 


Syntax 


Describes the command syntax or the routine definition. Section 5 
reference pages do not use the Syntax heading. 


Description Provides a detailed description of the entry’s features, usage, and 
syntax variations. 


Options Describes the command-line options. 

Restrictions Describes limitations or restrictions on the use of a command or 
routine. 


Examples Provides examples of how a command or routine is used. 
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Return Values Describes the values returned by a system call or routine. Used in 
Sections 2 and 3 only. 

Diagnostics Describes diagnostic and error messages that can appear. 

Files Lists related files that are either a part of the command or used 

during execution. 

Environment Describes the operation of the system call or routine when 

compiled in the POSIX and SYSTEM V environments. If the 
environment has no effect on the operation, this heading is not 
used. Used in Sections 2 and 3 only. 

See Also Lists related reference pages and documents in the ULTRIX 

documentation set. 

Conventions 

The following documentation conventions are used in the reference pages. 

% The default user prompt is your system name followed by a right 

angle bracket. In this manual, a percent sign (%) is used to 
represent this prompt. 

# A number sign is the default superuser prompt. 

user input This bold typeface is used in interactive examples to indicate 
typed user input. 

system output This typeface is used in text to indicate the exact name of a 

command, routine, partition, pathname, directory, or file. This 
typeface is also used in interactive examples to indicate system 
output and in code examples and other screen displays. 

UPPERCASE The ULTRIX system differentiates between lowercase and 

lowercase uppercase characters. Literal strings that appear in text, 

examples, syntax descriptions, and function definitions must be 
typed exactly as shown. 

rlogin This typeface is used for command names in the Syntax portion 

of the reference page to indicate that the command is entered 
exactly as shown. Options for commands are shown in bold 
wherever they appear. 

filename In examples, syntax descriptions, and routine definitions, italics 

are used to indicate variable values. In text, italics are used to 
give references to other documents. 

[ ] In syntax descriptions and routine definitions, brackets indicate 

items that are optional. 

{ I } In syntax descriptions and routine definitions, braces enclose lists 

from which one item must be chosen. Vertical bars are used to 
separate items. 
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In syntax descriptions and routine definitions, a horizontal ellipsis 
indicates that the preceding item can be repeated one or more 
times. 

A vertical ellipsis indicates that a portion of an example that 
would normally be present is not shown. 


cat(l) Cross-references to the ULTRIX Reference Pages include the 

appropriate section number in parentheses. For example, a 
reference to cat(l) indicates that you can find the material on the 
cat command in Section 1 of the reference pages. 


Online Reference Pages 

The ULTRIX reference pages are available online if installed by your system 
administrator. The man command is used to display the reference pages as follows: 

To display the ls(l) reference page: 

% man Is 

To display the passwd(l) reference page: 

% man passwd 

To display the passwd(5) reference page: 

% man 5 passwd 

To display the Name lines of all reference pages that contain the word “passwd”: 

% man -k passwd 

To display the introductory reference page for the family of 3xti reference pages: 

% man 3xt± intro 

Users on ULTRIX workstations can display the reference pages using the 
unsupported xman utility if installed. See the xman(lX) reference page for details. 

Reference Pages for Unsupported Software 

The reference pages for the optionally installed, unsupported ULTRIX software are in 
the document Reference Pages for Unsupported Software. 
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intro (7) 


Name 

intro - miscellaneous useful information pages 

Description 

This section contains miscellaneous documentation, mostly in the area of text 
processing macro packages for nr of f and other *rof f formatters. 


Macro Packages and Conventions 7-1 



ascii (7) 


Name 

ascii - map of ASCII character set 


Syntax 


cat /usr/pub/ascii 

Description 


The ascii file is a map of the ASCII character set, to be printed as needed. It 
contains: 


1000 

nul 

1001 

soh!002 

s tx 

1003 

etx 

1004 

eot1005 

enq 

1006 

ack 

1007 

bel 1 

1010 

bs 

1011 

ht 

1012 

nl 

1013 

vt 

1014 

np 

1015 

cr 

1016 

so 

1017 

s i 1 

1020 

die 

1021 

del 1022 

dc2 

1023 

dc3 

1024 

dc41025 

nak 

1026 

syn 

1027 

etb 1 

1030 

can 

1031 

em 

1032 

sub 

1033 

esc 

1034 

fs 

1035 

gs 

1036 

rs 

1037 

us 1 

1040 

sp 

1041 

| 

1042 

ft 

1043 

# 

1044 

$ 

1045 

% 

1046 

& 

1047 

' 1 

1050 

( 

1051 

) 

1052 

* 

1053 

+ 

1054 

9 

1055 

— 

1056 


1057 

/ 1 

1060 

0 

1061 

1 

1062 

2 

1063 

3 

1064 

4 

1065 

5 

1066 

6 

1067 

7 1 

1070 

8 

1071 

9 

1072 

* 

1073 

9 

1074 

< 

1075 

= 

1076 

> 

1077 

? 1 

1100 

@ 

1101 

A 

1102 

B 

1103 

c 

1104 

D 

1105 

E 

1106 

F 

1107 

G 1 

1110 

H 

1111 

I 

1112 

J 

1113 

K 

1114 

L 

1115 

M 

1116 

N 

1117 

O 1 

1120 

P 

1121 

Q 

1122 

R 

1123 

S 

1124 

T 

1125 

U 

1126 

V 

1 127 

W 1 

1130 

X 

1131 

Y 

1132 

Z 

1133 

[ 

1134 

\ 

1135 

] 

1136 

A 

1137 


1140 

X 

1 141 

a 

1142 

b 

1143 

c 

1144 

d 

1145 

e 

1146 

f 

1147 

g 1 

1150 

h 

1151 

i 

1152 

j 

1153 

k 

1154 

1 

1155 

m 

1156 

n 

1157 

o 1 

1160 

P 

1161 

q 

1162 

r 

1163 

s 

1164 

t 

1165 

u 

1166 

V 

1167 

w 1 

1170 

X 

1171 

y 

1172 

z 

1173 

{ 

1174 

1 

(175 

} 

1176 

~ 

1 177 

del 1 

1 00 

nul 

1 01 

sohl 02 

stx 

1 03 

etx 

1 04 

eotl 05 

enq 

i 06 

ack 

1 07 

bel I 

1 08 

bs 

1 09 

ht 

1 0a 

nl 

1 0b 

vt 

1 0c 

np 

1 Od 

cr 

1 Oe 

so 

1 Of 

s i 1 

1 10 

die 

1 11 

del 

1 12 

dc2 

1 13 

dc3 

1 14 

dc41 15 

nak 

1 16 

syn 

i 17 

etb 1 

1 18 

can 

1 19 

em 

1 la 

sub 

1 lb 

esc 

1 lc 

f s 

1 Id 

gs 

1 le 

r s 

1 If 

us 1 

i 20 

sp 

1 21 

i 

1 22 

it 

1 23 

# 

1 24 

$ 

1 25 

% 

1 26 

& 

1 27 

✓ | 

I 28 

( 

1 29 

) 

1 2a 

* 

I 2b 

+ 

1 2c 

9 

I 2d 

— 

1 2e 

# 

1 2f 

/ 1 

1 30 

0 

1 31 

1 

1 32 

2 

1 33 

3 

1 34 

4 

1 35 

5 

! 36 

6 

1 37 

7 1 

1 38 

8 

I 39 

9 

1 3a 

: 

1 3b 

9 

1 3c 

< 

i 3d 

= 

1 3e 

> 

1 3f 

? 1 

1 40 

@ 

1 41 

A 

1 42 

B 

1 43 

C 

1 44 

D 

1 45 

E 

i 46 

F 

1 47 

G 1 

1 48 

H 

1 49 

I 

1 4a 

J 

1 4b 

K 

1 4c 

L 

1 4d 

M 

1 4e 

N 

1 4f 

O ! 

1 50 

P 

1 51 

Q 

1 52 

R 

1 53 

S 

1 54 

T 

I 55 

U 

1 56 

V 

1 57 

W 1 

1 58 

X 

1 59 

Y 

1 5a 

Z 

1 5b 

[ 

I 5c 

\ 

1 5d 

] 

1 5e 

A 

1 5f 


1 60 

V 

1 61 

a 

1 62 

b 

I 63 

c 

1 64 

d 

1 65 

e 

I 66 

f 

1 67 

g 1 

1 68 

h 

1 69 

i 

1 6a 

j 

1 6b 

k 

1 6c 

1 

1 6d 

m 

1 6e 

n 

1 6f 

o 1 

1 70 

P 

1 71 

q 

i 72 

r 

1 73 

s 

1 74 

t 

i 75 

u 

1 76 

V 

1 77 

w 1 

i 78 

X 

1 79 

y 

1 7a 

z 

1 7b 

{ 

1 7c 

1 

1 7d 

} 

1 7e 

~ 

1 7f 

del 1 


Files 

/usr/pub/ascii 
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environ (7) 


Name 


environ - user environment 


Syntax 

extern char **environ; 

Description 

An array of strings, called the environment, is made available by execve when a 
process begins. By convention, these strings have the form “ name=value ”. The 
following names are used by various commands: 

PATH The sequence of directory prefixes that sh, time, and nice apply in 

searching for a file known by an incomplete path name. The prefixes are 
separated by a colon (:). The login(l) command sets 
PATH=:/usr/ucb:/bin:/usr/bin. 

HOME A user’s login directory, set by login from the password file passwd. 

TERM The kind of terminal for which output is to be prepared. This 

information is used by commands, such asnrofforplot, which may 
exploit special terminal capabilities. See /etc/termcap in 
termcap(5) for a list of terminal types. 

SHELL The file name of the user’s login shell. 

TERMCAP The string describing the terminal in TERM or the name of the termcap 
file. For further information, see termcap(5) and termcap(3x). 

EXINIT A startup list of commands read by ex, edit, and vi. 

USER The login name of the user. 

PRINTER The name of the default printer to be used by lpr, lpq, and lprm. 

Further names may be placed in the environment by the export command and 
“name=value” arguments in sh, or by the setenv command if you use csh. 
Arguments can also be placed in the environment at the point of an execve. It is 
unwise to conflict with certain sh variables that are frequently exported by 
.profile files: MAIL, PS1, PS2, and IFS. 

See Also 

csh(l), ex(l), login(l), sh(l), execve(2), system(3), termcap(3x), passwd(5), 
termcap(5) 
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RISC hier(7) 


Name 


hier - file system hierarchy 

Description 

The following is a brief description of the root file system. The major directory 
hierarchy and representative files are listed. 

Symbolic links can be included in the files to provide backward compatibility. To 
display the links, type: 

% Is -1 


See the Guide to Disk Maintenance for more detailed information. 

/ Directory for root file system. This file system is separated into nonsharable 

data, (root (/)) and sharable data, (/usr). These two file systems are 
each divided into the following types: static data, variable data, and 
executable data. 

/bin Directory for the single user executable data files. 

/bin/init Parent of all processes, init(8). 

/bin/mount 

Mount program, mount(8). 

/dev Directory for devices. 

MAKEDEV 

Shell script to create special files 
MAKEDEV.Iocal 

Site-specific part of MAKEDEV 
console Main console, tty(4) 
rz SCSI disks, rz(4) 

rrz* Raw SCSI disks, rz(4) 

rmt* Tapes 

mrmt* Tapes 

tty* Terminals, tty(4) 


/etc 


Directory for the machine-specific static data files and shell scripts for 
booting. 

crontab System clock daemon table, crontab(5) 

disktab Disk characteristics and partition tables, disktab(5) 
fstab File system configuration table, f stab(5) 

group Group file, group(5) 

hosts Host name-to-network address mapping file, hosts(5) 

motd Message-of-the-day file, login(l) 

networks Network name-to-network number mapping file, 

networks(5) 

passwd Password file, passwd(5) 

protocols Name-to-number mapping file, protocols(5) 

rc Shell script to bring the system to multiuser mode 
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hier (7) RISC 


rc.local Site-dependent portion of rc 

remote Names and description of remote hosts for tip(lc) and 
remote(5) 

services Network services definition file, services(5) 

termcap Description of terminal capabilities, termcap(5) 

ttys Properties of terminals, ttys(5) 


/lib Symbolic link to /usr/lib. 

/lost+found 

Directory for connecting detached files for f sck(8). 

/sys Symbolic link, normally to /usr/sys. 

/tmp Directory for temporary files (see also /usr/tmp). 
e* Used by ed(l) 

ctm* Used by cc(l) 


/usr General purpose directory, on which the /usr file system is normally 
mounted (see description that follows). 

/var Directory for variable length files, such as spool, administrative, and 

temporary files. These files can also be located in /usr/var. See the 
Guide to Disk Maintenance. 

/vmunix Kernel image 

The /usr directory contains the sharable data. The following is a brief description of 
the /usr file system. The major directory hierarchy and representative files are 
listed. 

/usr Root directory for /usr file system. 

/usr/adm Directory for administrative information, which is now a symbolic link 
to /var/adm. 

crash Directory for crash dumps 
vmcore.?,vmunix.? Crash dump files 

lpacct Line printer accounting, lpr(l) 
tracct Phototypesetter accounting, trof f(l) 
wtmp Login history, utmp(5) 
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RISC hier(7) 


/usr/bin Directory for the shared executable data files, including utility programs 
and Shell scripts, 
as assembler 

cc C compiler executive (see also /usr/lib/ccom and 
/usr/lib/cpp) 
csh C shell 


/usr/dict Directory for word lists. 

spellhist History file, spe 11(1) 

words Word list, look(l) 


/usr/doc Directories containing files for the Vol.2 documentation, 
as Assembler manual 
c C manual 


/usr/etc Directory for utility programs and shell scripts. 

/usr/etc/cron 

Clock daemon, cron(8). 

/usr/etc/dump 

Dump program, dump (8). 

/usr/examples 

A directory where components of the base system and Digital’s 
separately licensed products can locate code examples, scripts, and 
demos for customers to use. A typical use is to complement printed 
documentation. 

/usr/games Directory for games. 

hangman Hangman game 

lib Library directory for games 


/usr/etc/getty 

Part of login, getty(8). 
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hier(7) RISC 


/usr/include 

Directory for standard #include files. 

a.out.h Object file layout, a. out(5) 

math.h matherr(3m) 

stdio.h Standard I/O, intro(3s) 

sys Symbolic link to /sys/h (system generation #include 

files) 


/usr/lib Directory for the shared static data files, such as object libraries, 
atrun System scheduler, at(l) 

cpp C preprocessor 

libc.a System calls and standard I/O (2,3,3S) 
font Directory for * r o f f (1) fonts 
lint Directory for utility files for lint (1) 

tmac Directory for *roff(l) macros 

units Data file of conversion tables forunits(l) 
uucp Directory for uucp(lc) programs and data 


/usr/man Directory for unformatted and preformatted reference (manual) pages, 
catl Section 1 (preformatted) 

cat2 Section 2 (preformatted) 

cat3 Section 3 (preformatted) 


manl Section 1 (unformatted) 

man2 Section 2 (unformatted) 

man3 Section 3 (unformatted) 


/usr/mdec Directory for ULTRIX boot files. 

/usr/msgs Directory for messages, msgs(l). 

/usr/new Directory for binaries of new versions of programs. 

/usr/preserve 

Directory for editor temp files preserved after crashes or hangups. 

/usr/skel Directory for sample user startup files. 

.cshrc Startup file for csh(l) 

.login Login startup file for csh(l) 

.mailrc Startup file for mail(l) 

.profile Startup file for sh(l) 

.project Lists information used by f inger(l) 
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RISC hier(7) 


/usr/spool Directory for delayed execution files, which is now a symbolic link to 
/var/spool. 

at Directory used by at(l) 
lpd Directory used by lpr(l) 

lock Present when line printer is active 
cf* Copy of file to be printed, if necessary 
df* Daemon control file, lpd(8) 
tf* Transient control file (exists while lpr is working) 
mail Mailboxes for ma i 1 (1) 

name Mail file for user name 

name.lock Lock file (exists while name is receiving 
mail) 

uucp Work files and staging area for uucp(lc) 

LOGFILE Summary log 

/usr/src Generic sources. 

usr.bin User sources 

troff nr of f and trof f sources 

term Directory of description files for new printers 

/usr/sys Directory for system files. 

b.mips BINARY for MIPS 

b.vax BINARY for VAX 

fs Filesystem SRC 

net Netword SRC 

mips MIPS-specific SRC 

vax VAX-specific SRC 

data System data files 

conf/{mips,vax) 

Configuration files 
h #include files 

SAS Standalone system 

sys Machine independent SRC 

/usr/tmp Symbolic link to /var/tmp. 

See Also 

apropos(l), find(l), finger(l), grep(l), ls(l), whatis(l), whereis(l), which(l), 

ncheck(8) 

Guide to Disk Maintenance 
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hier(7) VAX 


Name 


hier - file system hierarchy 

Description 

The following is a brief description of the root file system. The major directory 
hierarchy and representative files are listed. 

Symbolic links can be included in the files to provide backward compatibility. To 
display the links, type: 

% Is -1 


See the Guide to Disk Maintenance for more detailed information. 

/ Directory for root file system. This file system is separated into nonsharable 

data (root (/)) and sharable data (/usr). These two file systems are each 
divided into the following types: static data, variable data, and executable 
data. 

/bin Directory for the single user executable data files. 

/bin/init Parent of all processes, in it (8). 

/bin/mount 

Mount program, mount(8). 

/dev Directory for devices. 

MAKEDEV 

Shell script to create special files 
MAKEDEV.local 

Site-specific part of MAKEDEV 
console Main console, tty(4) 

hp* disks, hp(4) 

rhp* Raw disks, hp(4) 

ra* UNIBUS disks, ra(4) 

tty* Terminals, tty(4) 


/etc Directory for the machine-specific static data files and shell scripts for 
booting. 

crontab 
disktab 
fstab 
group 
hosts 
motd 
networks 


passwd 

protocols 

rc 

rcdocal 


System clock daemon table, crontab(5) 

Disk characteristics and partition tables, disktab(5) 
File system configuration table, f stab(5) 

Group file, group(5) 

Host name-to-network address mapping file, hosts(5) 
Message-of-the-day file, login(l) 

Network name-to-network number mapping file, 
networks(5) 

Password file, passwd(5) 

Name-to-number mapping file, protocols(5) 

Shell script to bring the system to multiuser mode 
Site-dependent portion of rc 
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remote Names and description of remote hosts for tip(lc) and 
remote(5) 

services Network services definition file, services(5) 
termcap Description of terminal capabilities, termcap(5) 

ttys Properties of terminals, ttys(5) 


/lib Symbolic link to /usr/lib. 

/lost+found 

Directory for connecting detached files for f sck(8). 

/sys Symbolic link, normally to /usr/sys. 

/tmp Directory for temporary files (see also /usr/tmp). 
e* Used by ed(l) 

ctm* Used by cc(l) 


/usr General purpose directory, on which the /usr file system is normally 
mounted (see description that follows). 

/var Directory for variable length files, such as spool, administrative, and 

temporary files. These files can also be located in /usr/var. See the 
Guide to Disk Maintenance. 

/vmunix Kernel image 

The /usr directory contains the sharable data. The following is a brief description of 
the /usr file system. The major directory hierarchy and representative files are 
listed. 

/usr Root directory for /usr file system. 

/usr/adm Directory for administrative information, which is now a symbolic link 
to /var/adm. 

crash Directory for crash dumps 
vmcore.?,vmunix.? Crash dump files 

Ipacct Line printer accounting, lpr(l) 
tracct Phototypesetter accounting, t r o f f (1) 
vaacct, vpacct 

Varian and Versatec accounting for vpr(l), vtrof f(l), 
pac(8) 

wtmp Login history, utmp(5) 


/usr/bin Directory for the shared executable data files, including utility programs 
and Shell scripts, 
as assembler 

cc C compiler executive (see also /lib/ccom, /lib/cpp, and 
/lib/c2) 
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hier (7) VAX 


csh C shell 


/usr/dict Directory for word lists. 

spellhist History file, spe 11(1) 

words Word list, look(l) 


/usr/doc Directories containing files for the Vol.2 documentation, 
as Assembler manual 

c C manual 


/usr/etc Directory for utility programs and shell scripts. 

/usr/etc/cron 

Clock daemon, cron(8). 

/usr/etc/dump 

Dump program, dump (8). 

/usr/examples 

A directory where components of the base system and Digital’s 
separately licensed products can locate code examples, scripts, and 
demos for customers to use. A typical use is to complement printed 
documentation. 

/usr/games Directory for games. 

hangman Hangman game 

lib Library directory for games 


/usr/etc/getty 

Part of login , getty(8). 

/usr/include 

Directory for standard #include files. 

a.out.h Object file layout, a. out(5) 

math.h matherr(3m) 

stdio.h Standard I/O, intro(3s) 

sys Symbolic link to /sys/h (system generation #include 

files) 


/usr/lib Directory for the shared static data files, such as object libraries, 
atrun System scheduler, at(l) 

ccom C compiler proper 


Macro Packages and Conventions 7-11 



VAX hier(7) 


cpp C preprocessor 

c2 C code improver 

libc.a System calls and standard I/O (2,3,3S) 

font Directory for *roff(l) fonts 

lint Directory for utility files for lint(1) 

tmac Directory for nrof f(l) and *rof f(l) macros 

units Data file of conversion tables for units(l) 

uucp Directory for uucp(lc) programs and data 


/usr/man Directory for unformatted and preformatted reference (manual) pages, 
catl Section 1 (preformatted) 

cat2 Section 2 (preformatted) 

cat3 Section 3 (preformatted) 


manl Section 1 (unformatted) 

man2 Section 2 (unformatted) 

man3 Section 3 (unformatted) 


/usr/mdec Directory for ULTRIX boot files. 

/usr/msgs Directory for messages, msgs(l). 

/usr/new Directory for binaries of new versions of programs. 

/usr/preserve 

Directory for editor temp files preserved after crashes or hangups. 

/usr/skel Directory for sample user startup files 
.cshrc Startup file for csh(l) 

.login Login startup file for csh(l) 

.mailrc Startup file for ma i 1 (1) 

.profile Startup file for sh(l) 

.project Lists information used by finger(l) 

/usr/spool Directory for delayed execution files, which is now a symbolic link to 
/var/spool. 

at Directory used by a t (1) 
lpd Directory used by lpr(l) 

lock Present when line printer is active 
cf* Copy of file to be printed, if necessary 
df* Daemon control file, lpd(8) 
tf* Transient control file (exists while lpr is working) 
mail Mailboxes for mail(l) 

name Mail file for user name 

name dock Lock file (exists while name is receiving 

mail) 

uucp Work files and staging area for uucp(lc) 

LOGFILE Summary log 
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/usr/src Generic sources. 

usr.bin User sources 

troff nr of f and troff sources 

term Directory of description files for new printers 

/usr/sys Directory for system files. 

BINARY System object files, make(l) 

cassette Files for boot cassette 

conf Configuration files, conf ig(8) 

data Drive partition tables 

floppy Files for floppy disk 

h #include files 

mdec Headers for 11/750 boot blocks 

net General network files 

netimp IMP network files 

netinet DARPA internet network files 

netpup PUP network files 

stand Standalone boot binaries 

sys Machine-dependent system files 

vax VAX-specific system files 

vaxif Network interface drivers for the VAX 

vaxmba Drivers for devices on the MASSBUS 

vaxuba Drivers for devices on the UNIBUS 

/usr/tmp Symbolic link to /var/tmp. 

See Also 

apropos(l), find(l), finger(l), grep(l), ls(l), whatis(l), whereis(l), which(l), 
crontab(5), ncheck(8) 

Guide to Disk Maintenance 
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Name 


mailaddr - mail addressing description 

Description 

Mail addresses are based on the ARPANET protocol listed in the SEE ALSO section 
of this reference page. In addition, the DECnet address format can be used, if 
DECnet is installed on your system. 

To send mail to DECnet users, use the following address format: 

nodename::username 

In this case, nodename is the name of the DECnet system, or host, on which the 
target user resides. 

Addresses based on the ARPANET protocol use the following general format: 

user@domain 

A domain is a hierarchical dot-separated list of subdomains. For example, the 
following address is interpreted from right to left: 

eric@monet.Berkeley.ARPA 

In the previous example, the message is directed to the ARPA name tables (which do 
not correspond exactly to the physical ARPANET). The message then proceeds to 
the Berkeley gateway, after which it is directed to the local host monet. When the 
message reaches monet, it is delivered to the user eric. 

Unlike some other forms of addressing, this does not imply any routing. Thus, an 
address that is specified as an ARPA address can travel by an alternate route if that 
route is more convenient or efficient. For example, from Berkeley, the message 
could go directly to monet over the Ethernet, rather than using the Berkeley 
ARPANET gateway. 

Abbreviations. In some instances, you do not have to type an entire domain name. 
Generally, any information that follows the first dot may be omitted if the sending 
and receiving domains are the same. For example, a user on calder.Berkeley.ARPA 
can eliminate the .Berkeley.ARPA when sending to eric@monet, because the sending 
and receiving hosts are the same. 

Other abbreviations are permitted when conflicts do not exist. For example, Berkeley 
ARPANET hosts can be accessed without adding the .ARPA, if their names do not 
conflict with a local host name. 

Compatible Addresses. To provide compatibility with the previous mail system, 
some old address formats are converted to the new format. In particular, host:'.user is 
converted to user@host providing consistency with the rcp(lc) command. 

The syntax hostluser is converted to user@host.UUCP. Before being sent on, 
user@host.UUCP is normally converted back to the hostluser form. This conversion 
is done for compatibility with older UUCP hosts. 

The current implementation cannot automatically route messages through the UUCP 
network. Thus, you must explicitly tell the mail system all the hosts your messages 
must be sent through to arrive at its final destination. 
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Case Distinctions. Domain names (that is, anything following the at sign (@)) can 
be a combination of upper- and lowercase characters with the exception of UUCP 
hostnames. Most hosts accept both upper- and lowercase in user names, with the 
exception of MULTICS sites. 

Differences with ARPA Protocols. Although the UNDC addressing scheme is based 
on the ARPA mail addressing protocols, there are some significant differences. 

Currently, the only top level domain defined by ARPA is the .ARPA domain itself. 
This is further restricted to having only one level of host specifier. That is, the 
addresses that ARPA accepts must be in the format user@host.ARPA (where ‘host’ 
is one word). For example, the following address is not legal under the ARPA 
protocols: 

eric@raonet.Berkeley.ARPA 

Thus, the previous address would be converted to a different format on output to the 
ARPANET. For example: 

eric%monet@Berkeley.ARPA 

Route-addrs. In some instances, a message must be routed through several hosts to 
reach its final destination. Usually, this action is invisible to the sender; however, it 
is sometimes desirable to route a message manually. Addresses that are moved 
manually are called route-addrs. The syntax is as follows: 

<@hosta,@hostb:user@hostc> 

The previous example directs the message to hosta, to hostb , and finally to hostc. 
This route is used regardless of a more efficient path to hostc. 

Route-addrs occur frequently on return addresses, because they are generally 
augmented by the software at each host. It is possible to ignore all but the user@host 
part of the address to determine the actual sender. 

Postmaster. Every site must have a user or user alias designated as postmaster to 
which problems with the mail system can be addressed. 

CSNET. To send messages to CSNET, use the following syntax: 

user.host@UDel-Relay 

See Also 

mail(l), sendmail(8) 

Crocker, D. H., Standard for the Format of Arpa Internet Text Messages, RFC822 
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Name 

man - the man macro package for online reference pages 

Syntax 

tbl file... | nroff [ -niV ] [ -rll ] -man | col | ... 
tbl file... | *troff [ -niV ] [ -rll ] -man |... 

Description 

The man macro package is used to format reference manual pages for online viewing 
or printing. The installed reference pages are formatted by the man(l) and the 
catman(8) commands, using the man macro package. 

The page size is 80 columns by 66 lines for nroff output and is 8.5" x 11" when 
formatted with *troff text formatters. Page numbers appear at the bottom of each 
output page with odd page numbers appearing on the right side and even page 
numbers appearing on the left side. 

The format of the ULTRIX online reference pages is determined by the 

man. repro(7) macro package. The man macros are a compatible subset of the 

man. repro macros. 

Macros 

The following describes the macros in the man macro package. 

Any text argument can range from zero to six words. Quotation marks (" ") can be 
used to include blanks in words. If text is not specified, special treatment is applied 
to the next input line that has text to be printed. In this way, . I can be used to 
italicize a whole line or . SM followed by . B to make small bold letters. 

A prevailing indent distance is remembered between successive indented paragraphs, 
and is reset to a default value upon reaching a nonindented paragraph. Default units 
for indents i are ens (an en is 1 nroff character or 1/2 em space in current point 
size). 

Typeface and size are reset to default values before each paragraph, and after 
processing font and size setting macros. 

.B [ text... ] Sets text text in boldface. If no text is specified, the next text line is 
set in boldface. 

.BI wordl word2 [ words... ] 

Sets wordl in boldface, word2 in an italic typeface, and then alternates 
between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 

,BR wordl word2 [ words... ] 

Sets wordl in boldface, wordl in a roman typeface, and then alternates 
between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 
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.CT character 

Prints the keyboard control character indicator < CTRL / character > . For 
example, . CT A prints as <CTRL/A> . 

Sets text in constant width font until another font change is found. 

Ends an unfilled display block (started by . Ds). Also ends automatic 
centering, if it was in effect. 

Starts an unfilled display block. Text between .Ds and .De is 
printed in a roman typeface, with ‘no fill* mode (no wrapping and 
blank lines allowed) in effect. The display block is set flush left. 

Restores default tabs. Default tabs are set to .5 inches, starting with 
•5i, li, ... . 

Ends an example and restores basic text defaults and indents. 

Starts an example. Text between . EX and . EE is printed in a 
constant width font with ‘no fill’ mode (no wrapping and blank lines 
allowed) in effect. The example is set flush left unless an indent i is 
specified. Units of i are ens. 

Sets text in a sans-serif typeface. If no text is specified, the next text 
line is set in a sans-serif typeface. 

Sets text in a sans-serif italic typeface. If no text is specified, the next 
text line is set in a sans-serif italic typeface. 

.HB [ words... ] 

Sets the text in underline mode or in a sans-serif bold typeface, 
depending on the type of text formatter (nrof f or trof f). If the 
text formatter is of type nrof f, the next 999 input lines are formatted 
in underline mode (nrof f italic mode), or all the lines up to a font 
change are formatted in underline mode, depending on which limit is 
encountered first. If the text formatter is of type trof f, text is set in 
a sans-serif bold typeface until a font change is encountered. Up to 
nine words can also be specified as arguments. 

.HP i Begins a paragraph with a hanging indent of i ens. 

.1 [ text... ] Sets text in an italic typeface. If no text is specified, the next text line 
is set in an italic typeface. 

.11 word Sets a temporary indent to the length of the specified word. 

.12 word Reverses one line and then sets a temporary indent to the length of the 

specified word. 

.IB wordl word.2 [ words... ] 

Sets wordl in an italic typeface, wordl in boldface, and then alternates 
between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 

.IP x i Sets the prevailing indent to i. Then begins the indented paragraph 

with a hanging tag given by the next text line. If the tag does not fit, 
the macro places the next text on a separate line. Tag x appears in 
bold typeface. 


.CW 

.De 

.Ds 

.DT 

.EE 

.EX [ i ] 

.G [ text... ] 
.GL [ text... ] 
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.IR wordl word2 [ words ... ] 

Sets wordl in an italic typeface, word! in a roman typeface, and then 
alternates between these two fonts for the remaining words, up to six 
words. Blanks between words are stripped unless the string is 
enclosed in quotation marks (" "). 

.LP Same as the . PP macro. This macro is obsolete, but is provided for 

backwards compatibility. 

.MS reference_page section jubsection [ punctuation ] 

Sets reference_page immediately followed by section jubsection in 
parentheses followed by optional punctuation, using fonts that 
distinguish this reference page reference from ordinary text. For 
example, manual(section). 

.NE Ends a note. Also cancels automatic centering if it was in effect. 

.NT [ header 1 ] [ C ] 

.NT [ C ] [ header.2 ] 

Starts a note. If no arguments are specified, the default header for the 
note is ‘NOTE’. If the first argument is the letter ‘C’, all text in the 
note is centered, for the next 99 text lines or until the . NE macro is 
called, whichever comes first. If the first argument is not ‘C’, it 
becomes the header of the note, even if header2 is also specified. The 
header2 argument becomes the header of the note if the first argument 
is ‘C\ 

Sets the interparagraph distance to v vertical spaces. Resets the 
distance to the default value if v is omitted. 

Sets x in an italic or constant width typeface (depending on the 
*rof f formatter type) and then reverts to the previous typeface. The 
optional argument y is appended to x with no space, but printed in the 
previous typeface. The x argument is usually a path name; y is usually 
punctuation. 

Sets x in the current typeface, sets y in an italic or constant width 
typeface (depending on the *rof f formatter type) and appends it to x, 
and finally reverts to the previous typeface. The optional argument z is 
appended to y, but printed in the previous typeface. Spaces are 
removed between x, y, and z, unless quotation marks (" ") are used to 
enclose strings with spaces. The x argument is usually a fixed path 
name; y is usually a variable path name; and z is usually punctuation. 

Starts a block paragraph. Sets the prevailing indent to .5i for nr of f 
and four picas for *troff text formatters. 

Sets the text in a roman typeface until another font change is 
encountered. Also ends nr of f underline mode if it was in effect. 

.RB wordl word2 [ words... ] 

Sets wordl in a roman typeface, word2 in boldface, and then alternates 
between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 

.RE [ k ] Returns to the kth relative right shift indent level. (Restores the left 
margin to the position prior to the &th . RS call). Specifying &=0 is 


.PD [ v ] 

.PN x[y ] 

.Pn x y [ z ] 

.PP 

.R 
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equivalent to specifying A:=l. If A: is omitted, . RE restores the left 
margin to the most recent previous position. When b= 1 or 0, the 
default . RS indent increment is restored. 

.RI wordl wordl [ words... ] 

Sets wordl in a roman typeface, wordl in an italic typeface, and then 
alternates between these two fonts for the remaining words, up to six 
words. Blanks between words are stripped unless the string is 
enclosed in quotation marks (" "). 

.RN Prints the return character indicator, < RETURN > . 

.RS [ i ] Shifts the left margin to the right (relatively) the amount of i ens. The 
. RS macro calls can be nested up to nine levels. If i is not specified 
for the first . RS call, the relative right shift increases .5 inch for 
nrof f, and four picas for *trof f text formatters. Nested . RS calls 
increment the relative indent by i ens, or by .25 inch for nrof f, or by 
2 picas for *troff text formatters. 

.SH text Creates a section header. 

.SM [ text ] Sets text to be two points smaller than the current point size. If no 
text is specified, the next text line is set in the smaller point size. 

.SS text Creates a subsection header. 

.TB [ words... ] 

Same as the . HB macro. This macro is is obsolete, but is provided for 
backwards compatibility. 

.TH nc[s][a][f)[x] 

Begins a new reference page and sets the page title. Also sets up 
headers and footers for output pages, sets up all defaults and traps, and 
calls the . DT and . PD macros. The title appears as a header on all 
pages of the formatted reference page. The n argument is the reference 
page name. The c argument is the primary section number or letter. 

The s argument is the subsection, if any. The a argument is for an 
optional machine architecture specific label; for example “VAX”. 

The/argument optionally alters a portion of the page footer. The x 
argument is for optional extra commentary; for example 
“Unsupported”. 

Fields n, c, and s appear together at the top of each output page (see 
the top of this page for an example). These fields alternate between 
the right top and left top of a page header, corresponding to odd and 
even page numbers. Field a appears opposing the page name in the 
header when formatted with nrof f, but appears as a bleed tab when 
formatted with *troff text formatters. The/argument appears in 
the page footer on the inside edge of the page (left for odd page 
numbers, right for even). The x argument appears underneath the page 
name in the header. 

The last three fields are optional. To skip a field, specify a pair of 
quotation marks ("") in the field to be skipped. 

.TP i Sets the prevailing indent to i. Then begins the indented paragraph 

with a hanging tag given by the next text line. If the tag does not fit, 
the macro places the next text on a separate line. 
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.VE End a vertical margin bar. 

•VS [ 4 ] Starts a vertical margin bar, if ‘4’ is specified; otherwise, the macro 
does nothing. 

Macros That Cause Line Breaks 

The following macros cause line breaks: 

De Ds EE EX HP IP 

LP PP RE SH SS TH 

TP 

Macros That Need Text Lines 

The following macros affect the following line of text if they are specified in the 
input without arguments: 

B BI BR G GL I 

IB IR RI RB SH SS 

SM 

Automatic hyphenation is turned on. However, last lines (ones that will cause a trap) 
are not hyphenated and the last and first two characters of a word are not split off. 

Characters printed from the Special Font are artificially bolded by three units 
whenever the current font is ‘3’. 

The default page size is 80 columns by 66 lines for nr of f output and 8.5" x 11" for 
output generated by *troff text formatters. The text area is horizontally placed on 
the page so that the effective page margin is .5 inches for nr of f and 7.5 picas for 

• t r o f f text formatters. 

The . TH macro sets up the following defaults: 

• Text is set in “noadjust” mode; the right margin is ragged. 

• The default interparagraph distance is lv for nr of f and .5v for *trof f text 
formatters. 

• The basic text indent is .5 inches for nrof f and four picas for *troff text 
formatters, from the left margin. 

• The maximum text line length is 7 inches for nrof f and 36 picas for *troff 
text formatters. 

• Sets tab stops every .5 inches. 

• The basic text point size is 11 points, with line spacing set to 12 points. 

• The basic text font is “R” (a roman typeface). 

• Reference page headers, section headers, and subsection headers are set in a 
sans-serif bold typeface. 

Options 

-il/V Numbers the first generated page as N. 

-rll Turns on line double-spacing mode. 
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Restrictions 

Predefined Registers 

The following registers are predefined by the man macro package and should not be 
changed: 

PO Page offset and page margin 

IN Left margin indent relative to the section headers 

LL Line length including IN 

PL Page length 

The register T is predefined when you specify the *rof f -rl option. Its default 
value is 0. The man(l) command does not use this option. 

Reserved Registers 

The following registers are reserved for internal use by the man, man . nopage, and 
man. repro macro packages: 

A1 DX EX 1 p p# 

PF 

In addition, registers beginning with the characters ‘)’, ‘]\ and *}* are also reserved 
for internal use. 

Registers predefined by the nr of f(l), tbl(l), commands, and the *eqn and 
*troff text preprocessors and formatters should not be redefined. 

Predefined Strings 

The following strings are predefined by the man macro package and should not be 
changed: 

lq " if nrof f, “ if *trof f 

rq " if nrof f, ” if *trof f 

S Command string to change type size to 10 points. 

Reserved Strings and Macros 

The following string and macro names are reserved for internal use by the man, 
man. nopage, and man. repro macro packages: 


## 

A1 

BD 

BK 

CD 

D 

DE 

DS 

HH 

ID 

LD 

NO 

NX 

ys 

P 

UF 

ya 

yn 

yi 


In addition, names begining with the characters *)*, *]*, and ‘} ’ are also reserved for 
internal use. 

Names predefined by the nrof f(1), tbl(l), commands, and the *eqn and *troff 
text preprocessors and formatters should not be redefined. 


Macro Packages and Conventions 7-21 



man (7) 


.TH Macro Restrictions 

The section number should only be 1-8, ‘n’, ‘1’, ‘o’, or ‘p\ Other values might not 
be recognized by the man(l) or catman(8) commands. 

Sections 6, 7, ‘n’, T, ‘o’, and ‘p’ do not currently have subsections, so subsections 
should not be specified. 

The architecture field (a) should not exceed four characters. A value longer than four 
characters might print outside the right page margin. 

Reference pages containing *eqn commands should be preprocessed by an *neqn 
text preprocessor before being installed on the system. 

Reference pages containing tbl(l) commands must not be preprocessed before being 
installed on the system. 

The Name Section 

The catman(8) command assumes the Name section of a reference page has the 
following format: 

name[, name, name ...] \- explanatory text 

There should be at least one space after any comma and only one space following the 
“backslash hyphen” (V). There should not be any *rof f commands in the 
explanatory text. The explanatory text should be brief. The catman(8) command 
combines information in the Name section with parameters of the . TH macro to 
create an entry in a database searched by the apropos(l), man(l), and whatis(l) 
commands. 

Portability Considerations 

The ULTRIX man macro packages contain extensions and enhancements borrowed 
from other macro packages. If you have a need to write portable reference pages, 
you should not use the following macros: 


CT 

CW 

De 

Ds 

EE 

EX 

G 

GL 

HB 

HP 

11 

12 

LP 

MS 

NE 

NT 

PN 

Pn 

R 

RN 

TB 

UF 




The LP and TB macros are obsolete. 

The ULTRIX man . TH macro differs from other implemenations of the . TH macro. 
The primary differences are in the placement of the page title, and third and fifth 
fields in the *rof f output. The page title (the page name and section number) is 
commonly placed on both sides of the page header in other implementations. The 
more common placement of the third field is in the center of the page footer. The 
more common placement of the fifth field is in the center of the page header. 

Use of the tbl(l) and *eqn commands should be avoided, because the version of 
the man(l) command in some other implementations might not preprocess reference 
pages through the tbl(l) command. The *eqn commands also might not be 
installed. 
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/usr/lib/tmac/tmac. an The man macro package file 

See Also 

col(l), man(l), nroff(l), tbl(l), man.nopage(7), man.repro(7), catman(8) 
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Name 

man.nopage - the man.nopage macro package for printing reference pages 

Syntax 

tbl file... | nroff [ -nN ] [ -rpS ] [ -rll ] -man.nopage | col |... 
tbl file... | *troff [ -nN ] [ -rpS ] [ -rll ] -man.nopage |... 

Description 

The man. nopage macro package is used to format reference manual pages for 
unpaginated viewing or for printing on line printers. The installed reference pages 
are formatted by the man(l) and the catman(8) commands, using the man macro 
package. 

The page width is 80 columns when formatted by the nroff(1) command and is 8.5 
inches when formatted with *troff text formatters. The output is unpaginated 
when formatted by the nroff command, hence the name ‘nopage’. The output is 
paginated when formatted by *trof f text formatters, with page numbers appearing 
at the bottom of each output page with odd page numbers appearing on the right side 
and even page numbers appearing on the left side. The *trof f output is similar to 
the output generated with the man . repro(7) macro package. 

The format of the ULTRIX online reference pages is determined by the 

man. repro(7) macro package. The man. nopage macros are a compatible subset 

of the man . repro macros. 


Macros 

The following describes the macros in the man macro package. 

Any text argument can range from zero to six words. Quotation marks (" ") can be 
used to include blanks in words. If text is not specified, special treatment is applied 
to the next input line that has text to be printed. In this way, . I can be used to 
italicize a whole line or . SM followed by . B to make small bold letters. 

A prevailing indent distance is remembered between successive indented paragraphs, 
and is reset to a default value upon reaching a nonindented paragraph. Default units 
for indents i are ens (an en is 1 nroff character or 1/2 em space in current point 
size). 

Typeface and size are reset to default values before each paragraph, and after 
processing font and size setting macros. 

.B [ text... ] Sets text text in boldface. If no text is specified, the next text line is 
set in boldface. 

.BI wordl word2 [ words... ] 

Sets wordl in boldface, word2 in an italic typeface, and then alternates 
between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 

.BR wordl wordl [ words... ] 

Sets wordl in boldface, word2 in a roman typeface, and then alternates 
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between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 

.CT character 

Prints the keyboard control character indicator < CTRL/ character > . For 
example, . CT A prints as <CTRL/A> . 

.CW Sets text in a constant width font until another font change is 

encountered. 

.De Ends an unfilled display block (started by . Ds). Also ends automatic 

centering, if it was in effect. 

.Ds Starts an unfilled display block. Text between .Ds and .De is 

printed in a roman typeface, with ‘no fill’ mode (no wrapping and 
blank lines allowed) in effect. The display block is set flush left. 

.DT Restores default tabs. Default tabs are set to .5 inches, starting with 

.5i, li, ... . 

.EE Ends an example and restores basic text defaults and indents. 

.EX [ i ] Starts an example. Text between . EX and . EE is printed in a 

constant width font with ‘no fill’ mode (no wrapping and blank lines 
allowed) in effect. The example is set flush left unless an indent i is 
specified. Units of i are ens. 

.G [ text... ] Sets text in a sans-serif typeface. If no text is specified, the next text 
line is set in a sans-serif typeface. 

.GL [ text... ] Sets text in a sans-serif italic typeface. If no text is specified, the next 
text line is set in a sans-serif italic typeface. 

.HB [ words... ] 

Sets the text in underline mode or in a sans-serif bold typeface, 
depending on the type of text formatter (nrof f or trof f). If the 
text formatter is of type nrof f, the next 999 input lines are formatted 
in underline mode (nrof f italic mode), or all the lines up to a font 
change are formatted in underline mode, depending on which limit is 
encountered first. If the text formatter is of type trof f, text is set in 
a sans-serif bold typeface until a font change is encountered. Up to 
nine words can also be specified as arguments. 

.HP i Begins a paragraph with a hanging indent of i ens. 

.1 [ text... ] Sets text in an italic typeface. If no text is specified, the next text line 
is set in an italic typeface. 

.11 word Sets a temporary indent to the length of the specified word. 

.12 word Reverses one line and then sets a temporary indent to the length of the 

specified word. 

.IB wordl word.2 [ words... ] 

Sets wordl in an italic typeface, word2 in boldface, and then alternates 
between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 
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.IP x i Sets the prevailing indent to i. Then begins the indented paragraph 

with a hanging tag given by the next text line. If the tag does not fit, 
the macro places the next text on a separate line. Tag x appears in 
bold typeface. 

.IR wordl word.2 [ words... ] 

Sets wordl in an italic typeface, word2 in a roman typeface, and then 
alternates between these two fonts for the remaining words, up to six 
words. Blanks between words are stripped unless the string is 
enclosed in quotation marks (" "). 

.LP Same as the . PP macro. This macro is obsolete, but is provided for 

backwards compatibility. 

.MS reference_page section jsubsection [ punctuation ] 

Sets reference_page immediately followed by section jubsection in 
parentheses followed by optional punctuation, using fonts that 
distinguish this reference page reference from ordinary text. For 
example, manual(section). 

.NE Ends a note. Also cancels automatic centering if it was in effect. 

.NT [ headerl ] [ C ] 

.NT [ C ] [ header2 ] 

Starts a note. If no arguments are specified, the default header for the 
note is ‘NOTE’. If the first argument is the letter ‘C\ all text in the 
note is centered, for the next 99 text lines or until the . NE macro is 
called, whichever comes first. If the first argument is not ‘C’, it 
becomes the header of the note, even if header2 is also specified. The 
header2 argument becomes the header of the note if the first argument 
is ‘C\ 

Sets the interparagraph distance to v vertical spaces. Resets the 
distance to the default value if v is omitted. 

Sets x in an italic or constant width typeface (depending on the 
*rof f formatter type) and then reverts to the previous typeface. The 
optional argument y is appended to x with no space, but printed in the 
previous typeface. The x argument is usually a path name; y is usually 
punctuation. 

Sets x in the current typeface, sets y in an italic or constant width 
typeface (depending on the *rof f formatter type) and appends it to x, 
and finally reverts to the previous typeface. The optional argument z is 
appended to y, but printed in the previous typeface. Spaces are 
removed between x, y, and z, unless quotation marks (" ") are used to 
enclose strings with spaces. The x argument is usually a fixed path 
name; y is usually a variable path name; and z is usually punctuation. 

Starts a block paragraph. Sets the prevailing indent to .5i for nr of f 
and four picas for *trof f text formatters. 

Sets the text in a roman typeface until another font change is 
encountered. Also ends nr of f underline mode if it was in effect. 

,RB wordl word2 [ words... ] 

Sets wordl in a roman typeface, word2 in boldface, and then alternates 
between these two fonts for the remaining words, up to six words. 


.PD [ v ] 

.PN x [ y ] 

.Pn x y [ z ] 

.PP 

.R 
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Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 

.RE [ k ] Returns to the kth relative right shift indent level. (Restores the left 
margin to the position prior to the Ath . RS call). Specifying h=0 is 
equivalent to specifying fc=l. If k is omitted, . RE restores the left 
margin to the most recent previous position. When b= 1 or 0, the 
default . RS indent increment is restored. 


.RI wordl word2 [ words... ] 

Sets wordl in a roman typeface, word2 in an italic typeface, and then 
alternates between these two fonts for the remaining words, up to six 
words. Blanks between words are stripped unless the string is 
enclosed in quotation marks (" "). 

.RN Prints the return character indicator, < RETURN > . 

.RS [ i ] Shifts the left margin to the right (relatively) the amount of i ens. The 
. RS macro calls can be nested up to nine levels. If i is not specified 
for the first . RS call, the relative right shift increases .5 inch for 
nrof f and four picas for *trof f text formatters. Nested .RS calls 
increment the relative indent by i ens, or by .25 inch for nrof f, or by 
2 picas for *trof f text formatters. 

.SH text Creates a section header. 


.SM [ text ] Sets text to be two points smaller than the current point size. If no 
text is specified, the next text line is set in the smaller point size. 

.SS text Creates a subsection header^ 

.TB [ words... ] 

Same as the . HB macro. This macro is is obsolete, but is provided for 
backwards compatibility. 

.TH nc[s][a][f][x] 

Begins a new reference page and sets the page title. Also sets up 
headers and footers for output pages, sets up all defaults and traps, and 
calls the . DT and . PD macros. The title appears as a header on all 
pages of the formatted reference page. The n argument is the reference 
page name. The c argument is the primary section number or letter. 

The 5 argument is the subsection, if any. The a argument is for an 
optional machine architecture specific label; for example “VAX”. 
The/ argument optionally alters a portion of the page footer. The x 
argument is for optional extra commentary; for example 
“Unsupported”. 

Fields n , c, and s appear together at the top of each output page (see 
the top of this page for an example). These fields alternate between 
the right top and left top of a page header, corresponding to odd and 
even page numbers. Field a appears opposing the page name in the 
header when formatted with nrof f, but appears as a bleed tab when 
formatted with *troff text formatters. The/argument appears in 
the page footer on the inside edge of the page (left for odd page 
numbers, right for even). The x argument appears underneath the page 
name in the header. 
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The last three fields are optional. To skip a field, specify a pair of 
quotation marks ("") in the field to be skipped. 

.TP i Sets the prevailing indent to i. Then begins the indented paragraph 

with a hanging tag given by the next text line. If the tag does not fit, 
the macro places the next text on a separate line. 

.VE End a vertical margin bar. 

.VS [ 4 ] Starts a vertical margin bar, if ‘4’ is specified; otherwise, the macro 
does nothing. 

Macros That Cause Line Breaks 

The following macros cause line breaks: 

De Ds EE EX HP IP 

LP PP RE SH SS TH 

TP 

Macros That Need Text Lines 

The following macros affect the following line of text if they are specified in the 
input without arguments: 

B BI BR G GL I 

IB IR RI RB SH SS 

SM 

Automatic hyphenation is turned on. However, last lines (ones that will cause a trap) 
are not hyphenated and the last and first two characters of a word are not split off. 

Characters printed from the Special Font are artificially bolded by three units 
whenever the current font is ‘3’. 

The default page width is 80 columns nr of f output and 8.5 inches for output 
generated by *trof f text formatters. The text area is horizontally placed on the 
page so that the effective page margin is .5 inches for nr of f and 7.5 picas for 
*troff text formatters. 

The default page length is unlimited (unpaginated) for nerof f output, but is 11 
inches for output generated by *trof f text formatters. 

The . TH macro sets up the following defaults: 

• Text is set in “noadjust” mode; the right margin is ragged. 

• The default interparagraph distance is lv for nrof f and .5v for *trof f text 
formatters. 

• The basic text indent is .5 inches for nrof f and four picas for *trof f text 
formatters, from the left margin. 

• The maximum text line length is 7 inches for nrof f and 36 picas for *troff 
text formatters. 

• Sets tab stops every .5 inches. 

• The basic text point size is 11 points, with line spacing set to 12 points. 

• The basic text font is “R” (a roman typeface). 

• Reference page headers, section headers, and subsection headers are set in a 
sans-serif bold typeface. 
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The default section number, which apepras like a “chapter” number in page footers 
is 0 for *trof f output. There are no page footers for nr of f output. 

Options 

-n N Numbers the first generated page as N. 

-rll Turns on line double-spacing mode. 

-rpS Sets the section number fo S. Section numbers appear in output page 

footers as S-N (chapter-page-number). 

Restrictions 

Predefined Registers 

The following registers are predefined by the man macro package and should not be 
changed: 

PO Page offset and page margin 

IN Left margin indent relative to the section headers 

LL Line length including IN 

PL Page length 

The register T is predefined when you specify the *rof f -rl option. Its default 
value is 0. The man(l) command does not use this option. 

The register ‘p’ is predefined when you specify the *rof f -rp option. Its default 
value is 0. The man(l) command does not use this option. 

Reserved Registers 

The following registers are reserved for internal use by the man, man. nopage, and 
man. repro macro packages: 

A1 DX EX 1 p p# 

PF 

In addition, registers beginning with the characters *)’, *]’, and ‘}* are also reserved 
for internal use. 

Registers predefined by the nrof f(1), tbl(l), commands, and the *eqn and 
*trof f text preprocessors and formatters should not be redefined. 

Predefined Strings 

The following strings are predefined by the man macro package and should not be 
changed: 

lq " if nrof f, “ if *trof f 

rq " if nrof f, ” if *trof f 

S Command string to change type size to 10 points. 
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Reserved Strings and Macros 

The following string and macro names are reserved for internal use by the man, 
man. nopage, and man. repro macro packages: 


## 

A1 

BD 

BK 

CD 

D 

DE 

DS 

HH 

ID 

LD 

NO 

NX 

ys 

P 

UF 

ya 

yn 

yi 


In addition, names begining with the characters *)’, *]*, and *}’ are also reserved for 
internal use. 

Names predefined by the nrof f(1), tbl(l), commands, and the *eqn and *troff 
text preprocessors and formatters should not be redefined. 

.TH Macro Restrictions 

The section number should only be 1-8, ‘n’, ‘1’, ‘o’, or ‘p’. Other values might not 
be recognized by the man(l) or catman(8) commands. 

Sections 6, 7, ‘n’, T, ‘o’, and ‘p’ do not currently have subsections, so subsections 
should not be specified. 

The architecture field (a) should not exceed four characters. A value longer than four 
characters might print outside the right page margin. 

Reference pages containing *eqn commands should be preprocessed by an *neqn 
text preprocessor before being installed on the system. 

Reference pages containing tbl(l) commands must not be preprocessed before being 
installed on the system. 

The Name Section 

The catman(8) command assumes the Name section of a reference page has the 
following format: 

name[, name, name ...] \- explanatory text 

There should be at least one space after any comma and only one space following the 
“backslash hyphen” (V). There should not be any *rof f commands in the 
explanatory text. The explanatory text should be brief. The catman(8) command 
combines information in the Name section with parameters of the . TH macro to 
create an entry in a database searched by the apropos(l), man(l), and whatis(l) 
commands. 

Portability Considerations 

The ULTRIX man macro packages contain extensions and enhancements borrowed 
from other macro packages. If you have a need to write portable reference pages, 
you should not use the following macros: 


CT 

CW 

De 

Ds 

EE 

EX 

G 

GL 

HB 

HP 

11 

12 

LP 

MS 

NE 

NT 

PN 

Pn 

R 

RN 

TB 

UF 
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The LP and TB macros are obsolete. 

The ULTRIX man . TH macro differs from other implemenations of the . TH macro. 
The primary differences are in the placement of the page title, and third and fifth 
fields in the *rof f output. The page title (the page name and section number) is 
commonly placed on both sides of the page header in other implementations. The 
more common placement of the third field is in the center of the page footer. The 
more common placement of the fifth field is in the center of the page header. 

Use of the tbl(l) and *eqn commands should be avoided, because the version of 
the man(l) command in some other implementations might not preprocess reference 
pages through the tbl(l) command. The *eqn commands also might not be 
installed. 

Files 

/usr/lib/tmac/tmac.an.nopage 

The man. nopage macro package file 

See Also 

col(l), man(l), nroff(l), tbl(l), man(7), man.repro(7), catman(8) 
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Name 

man.repro - the man.repro macro package for typesetting reference pages 

Syntax 

tbl file... | nroff [ -nN ] [ -rpS ] [ -rll ] -man.repro | col |... 
tbl file... | *troff [ -nN ] [ -rp S ] [ -rll ] -man.repro |... 

Description 

The man. repro macro package is used to format reference manual pages for 
printing or typsetting. This reference page was formatted by a *trof f text 
formatter, using the man. repro macro package, nroff(1) command, using the 
man. repro macro package, or was formatted by the man(l) and the catman(8) 
commands, using the man macro package. 

The page size is 80 columns by 66 lines for nroff output and is 8.5" x 11" when 
formatted with *troff text formatters. Page numbers appear at the bottom of each 
output page with odd page numbers appearing on the right side and even page 
numbers appearing on the left side. Page footers can optionally include the name of 
the reference page section. 

The format of the ULTRIX online reference pages is determined by the man. repro 
macro package. 

Macros 

The following describes the macros in the man. repro macro package. 

Any text argument can range from zero to six words. Quotation marks (" ") can be 
used to include blanks in words. If text is not specified, special treatment is applied 
to the next input line that has text to be printed. In this way, . I can be used to 
italicize a whole line or . SM followed by . B to make small bold letters. 

A prevailing indent distance is remembered between successive indented paragraphs, 
and is reset to a default value upon reaching a nonindented paragraph. Default units 
for indents i are ens (an en is 1 nroff character or 1/2 em space in current point 
size). 

Typeface and size are reset to default values before each paragraph, and after 
processing font and size setting macros. 

.B [ text... ] Sets text text in boldface. If no text is specified, the next text line is 
set in boldface. 

,BI wordl wordl [ words... ] 

Sets wordl in boldface, word2 in an italic typeface, and then alternates 
between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 

.BR wordl wordl [ words... ] 

Sets wordl in boldface, wordl in a roman typeface, and then alternates 
between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 
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.CT character 

Prints the keyboard control character indicator < CTRL / character > . For 
example, . CT A prints as <CTRL/A> . 

Sets text in a constant width font until another font change is 
encountered. 

Ends an unfilled display block (started by . Ds). Also ends automatic 
centering, if it was in effect. 

Starts an unfilled display block. Text between . Ds and . De is 
printed in a roman typeface, with ‘no fill’ mode (no wrapping and 
blank lines allowed) in effect. The display block is set flush left. 

Restores default tabs. Default tabs are set to .5 inches, starting with 
•5i, li, ... . 

Ends an example and restores basic text defaults and indents. 

Starts an example. Text between . EX and . EE is printed in a 
constant width font with ‘no fill’ mode (no wrapping and blank lines 
allowed) in effect. The example is set flush left unless an indent i is 
specified. Units of i are ens. 

Sets text in a sans-serif typeface. If no text is specified, the next text 
line is set in a sans-serif typeface. 

Sets text in a sans-serif italic typeface. If no text is specified, the next 
text line is set in a sans-serif italic typeface. 

.HB [ words... ] 

Sets the text in underline mode or in a sans-serif bold typeface, 
depending on the type of text formatter (nrof f or trof f). If the 
text formatter is of type nr of f, the next 999 input lines are formatted 
in underline mode (nrof f italic mode), or all the lines up to a font 
change are formatted in underline mode, depending on which limit is 
encountered first. If the text formatter is of type trof f, text is set in 
a sans-serif bold typeface until a font change is encountered. Up to 
nine words can also be specified as arguments. 

.HP i Begins a paragraph with a hanging indent of i ens. 

.1 [ text... ] Sets text in an italic typeface. If no text is specified, the next text line 
is set in an italic typeface. 

.11 word Sets a temporary indent to the length of the specified word. 

.12 word Reverses one line and then sets a temporary indent to the length of the 

specified word. 

.IB wordl word2 [ words... ] 

Sets wordl in an italic typeface, word.2 in boldface, and then alternates 
between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 

.IP x i Sets the prevailing indent to i. Then begins the indented paragraph 

with a hanging tag given by the next text line. If the tag does not fit, 
the macro places the next text on a separate line. Tag x appears in 
bold typeface. 


.CW 

.De 

.Ds 

.DT 

.EE 

.EX [ i ] 

.G [ text... ] 
,GL [ text... ] 
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.IR wordl word2 [ words... ] 

Sets wordl in an italic typeface, word'2 in a roman typeface, and then 
alternates between these two fonts for the remaining words, up to six 
words. Blanks between words are stripped unless the string is 
enclosed in quotation marks (" "). 

.LP Same as the .PP macro. This macro is obsolete, but is provided for 

backwards compatibility. 

.MS reference_page section jubsection [ punctuation ] 

Sets reference_page immediately followed by section subsection in 
parentheses followed by optional punctuation, using fonts that 
distinguish this reference page reference from ordinary text. For 
example, manual(section). 

.NE Ends a note. Also cancels automatic centering if it was in effect. 

.NT [ headerl ] [ C ] 

.NT [ C ] [ header2 ] 

Starts a note. If no arguments are specified, the default header for the 
note is ‘NOTE’. If the first argument is the letter ‘C\ all text in the 
note is centered, for the next 99 text lines or until the . NE macro is 
called, whichever comes first. If the first argument is not ‘C\ it 
becomes the header of the note, even if header2 is also specified. The 
header2 argument becomes the header of the note if the first argument 
is ‘C\ 

Sets the interparagraph distance to v vertical spaces. Resets the 
distance to the default value if v is omitted. 

Sets x in an italic or constant width typeface (depending on the 
*rof f formatter type) and then reverts to the previous typeface. The 
optional argument y is appended to x with no space, but printed in the 
previous typeface. The x argument is usually a path name; y is usually 
punctuation. 

Sets x in the current typeface, sets y in an italic or constant width 
typeface (depending on the *rof f formatter type) and appends it to x, 
and finally reverts to the previous typeface. The optional argument z is 
appended to y, but printed in the previous typeface. Spaces are 
removed between x, y, and z, unless quotation marks (" ") are used to 
enclose strings with spaces. The x argument is usually a fixed path 
name; y is usually a variable path name; and z is usually punctuation. 

Starts a block paragraph. Sets the prevailing indent to .5i for nr of f 
and four picas for *troff text formatters. 

Sets the text in a roman typeface until another font change is 
encountered. Also ends nr of f underline mode if it was in effect. 

.RB wordl wordl [ words... 1 

Sets wordl in a roman typeface, word2 in boldface, and then alternates 
between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 

.RE [ k ] Returns to the &th relative right shift indent level. (Restores the left 
margin to the position prior to the £th . RS call). Specifying k=0 is 


.PD [ v ] 

.PNxfy] 

.Pn x y [ z ] 

.PP 

.R 
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equivalent to specifying k= 1. If A: is omitted, . RE restores the left 
margin to the most recent previous position. When k-\ or 0, the 
default . RS indent increment is restored. 

.RI wordl word2 [ words... ] 

Sets wordl in a roman typeface, wordl in an italic typeface, and then 
alternates between these two fonts for the remaining words, up to six 
words. Blanks between words are stripped unless the string is 
enclosed in quotation marks (" "). 

.RN Prints the return character indicator, < RETURN > . 

.RS [ i ] Shifts the left margin to the right (relatively) the amount of i ens. The 
. RS macro calls can be nested up to nine levels. If i is not specified 
for the first . RS call, the relative right shift increases .5 inch for 
nroff and four picas for *trof f text formatters. Nested .RS calls 
increment the relative indent by i ens, or by .25 inch for nroff, or by 
2 picas for *trof f text formatters. 

.SH text Creates a section header. 

.SM [ text ] Sets text to be two points smaller than the current point size. If no 
text is specified, the next text line is set in the smaller point size. 

.SS text Creates a subsection header. 

.TB [ words... ] 

Same as the . HB macro. This macro is is obsolete, but is provided for 
backwards compatibility. 

.TH nc[s][a][f][x] 

Begins a new reference page and sets the page title. Also sets up 
headers and footers for output pages, sets up all defaults and traps, and 
calls the . DT and . PD macros. The title appears as a header on all 
pages of the formatted reference page. The n argument is the reference 
page name. The c argument is the primary section number or letter. 

The s argument is the subsection, if any. The a argument is for an 
optional machine architecture specific label; for example “VAX”. 

The/argument optionally alters a portion of the page footer. The x 
argument is for optional extra commentary; for example 
“Unsupported”. 

Fields n, c, and s appear together at the top of each output page (see 
the top of this page for an example). These fields alternate between 
the right top and left top of a page header, corresponding to odd and 
even page numbers. Field a appears opposing the page name in the 
header when formatted with nroff, but appears as a bleed tab when 
formatted with *troff text formatters. The /argument appears in 
the page footer on the inside edge of the page (left for odd page 
numbers, right for even). The x argument appears underneath the page 
name in the header. 

The last three fields are optional. To skip a field, specify a pair of 
quotation marks ("") in the field to be skipped. 

.TP i Sets the prevailing indent to i. Then begins the indented paragraph 

with a hanging tag given by the next text line. If the tag does not fit, 
the macro places the next text on a separate line. 
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.UF footer Replaces the section name (adjacent to the ‘chapter-pagejnumber’ pair 
in the page footer), defined by the -rpS option, with the text footer. 
This macro must not be called before the . TH macro. 

.VE End a vertical margin bar. 

•VS [ 4 ] Starts a vertical margin bar, if ‘4’ is specified; otherwise, the macro 
does nothing. 

Macros That Cause Line Breaks 

The following macros cause line breaks: 

De Ds EE EX HP IP 

LP PP RE SH SS TH 

TP 

Macros That Need Text Lines 

The following macros affect the following line of text if they are specified in the 
input without arguments: 

B BI BR G GL I 

IB IR RI RB SH SS 

SM 

Automatic hyphenation is turned off. 

Characters printed from the Special Font are artificially bolded by three units 
whenever the current font is ‘3’. 

The default page size is 80 columns by 66 lines for nr of f output and 8.5" x 11" for 
output generated by *trof f text formatters. The text area is horizontally placed on 
the page so that the effective page margin is .5 inches for nr of f and 7.5 picas for 
*trof f text formatters. 

The . TH macro sets up the following defaults: 

• Text is set in “noadjust” mode; the right margin is ragged. 

• The default interparagraph distance is lv for nrof f and .5v for *trof f text 
formatters. 

• The basic text indent is .5 inches for nrof f and four picas for *trof f text 
formatters, from the left margin. 

• The maximum text line length is 7 inches for nrof f and 36 picas for *troff 
text formatters. 

• Sets tab stops every .5 inches. 

• The basic text point size is 11 points, with line spacing set to 12 points. 

• The basic text font is “R” (a roman typeface). 

• Reference page headers, section headers, and subsection headers are set in a 
sans-serif bold typeface. 
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Options 

-nN Numbers the first generated page as N. 

-rll Turns on line double-spacing mode. 

-rpS Sets the section number to S. The section number determines if the 

name of a section will appear in the page footer. If the value of S is 0, 
no name appears in the page footer. When S is specified, that number 
determines the name that will appear in the footer. The section 
number appears in output page footers as S-N (chapter-page-number). 
If S is not 0, the name of the section appears on the inside of the page 
footer, adjacent to the chapter-page-number sequence. 

Restrictions 

Predefined Registers 

The following registers are predefined by the man macro package and should not be 


changed: 


PO 

Page offset and page margin 

IN 

Left margin indent relative to the section headers 

LL 

Line length including IN 

PL 

Page length 


The register T is predefined when you specify the *roff -rl option. Its default 
value is 0. The man(l) command does not use this option. 

The register ‘p’ is predefined when you specify the *rof f -rp option. Its default 
value is 0. The man(l) command does not use this option. 

The register ‘p’ should be set to a range 1-8 or 11-18 for unsupported reference 
pages. It cannot be set to values T, ‘n’, ‘o’, or ‘p’. 

Reserved Registers 

The following registers are reserved for internal use by the man, man. nopage, and 
man. repro macro packages: 

A1 DX EX 1 p p# 

PF 

In addition, registers beginning with the characters ‘)’, *]*, and *}* are also reserved 
for internal use. 

Registers predefined by the nrof f(1), tbl(l), commands, and the *eqn and 
*troff text preprocessors and formatters should not be redefined. 

Predefined Strings 

The following strings are predefined by the man macro package and should not be 
changed: 

Iq " if nrof f, “ if *trof f 

rq " if nrof f, ” if *trof f 
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S Command string to change type size to 10 points. 

Reserved Strings and Macros 

The following string and macro names are reserved for internal use by the man, 
man. nopage, and man. repro macro packages: 


## 

A1 

BD 

BK 

CD 

D 

DE 

DS 

HH 

ID 

LD 

NO 

NX 

P 

ya 

yn 

yi 

ys 


In addition, names begining with the characters *)*» *]*, and *}* are also reserved for 
internal use. 

Names predefined by the nr of f(l), tbl(l), commands, and the *eqn and *trof f 
text preprocessors and formatters should not be redefined. 

.TH Macro Restrictions 

The section number should only be 1-8, ‘n’, T, ‘o’, or ‘p’. Other values might not 
be recognized by the man(l) or catman(8) commands. 

Sections 6, 7, ‘n’, T, ‘o’, and ‘p’ do not currently have subsections, so subsections 
should not be specified. 

The architecture field (a) should not exceed four characters. A value longer than four 
characters might print outside the right page margin. 

Reference pages containing *eqn commands should be preprocessed by an *neqn 
text preprocessor before being installed on the system. 

Reference pages containing tbl(l) commands must not be preprocessed before being 
installed on the system. 

The Name Section 

The catman(8) command assumes the Name section of a reference page has the 
following format: 

name[, name, name ...] \- explanatory text 

There should be at least one space after any comma and only one space following the 
“backslash hyphen’’ (V). There should not be any *rof f commands in the 
explanatory text. The explanatory text should be brief. The catman(8) command 
combines information in the Name section with parameters of the . TH macro to 
create an entry in a database searched by the apropos(l), man(l), and whatis(l) 
commands. 

Portability Considerations 

The ULTRIX man macro packages contain extensions and enhancements borrowed 
from other macro packages. If you have a need to write portable reference pages, 
you should not use the following macros: 


CT 

CW 

De 

Ds 

EE 

EX 

G 

GL 

HB 

HP 

11 

12 

LP 

MS 

NE 

NT 

PN 

Pn 

R 

RN 

TB 

UF 
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The LP and TB macros are obsolete. 

The ULTRIX man . TH macro differs from other implemenations of the . TH macro. 
The primary differences are in the placement of the page title, and third and fifth 
fields in the *rof f output. The page title (the page name and section number) is 
commonly placed on both sides of the page header in other implementations. The 
more common placement of the third field is in the center of the page footer. The 
more common placement of the fifth field is in the center of the page header. 

Use of the tbl(l) and *eqn commands should be avoided, because the version of 
the man(l) command in some other implementations might not preprocess reference 
pages through the tbl(l) command. The *eqn commands also might not be 
installed. 

Examples 

The following example processes this manual page for a character-cell device: 

% cd /usr/man/man7 

% tbl xnan.repro.7 | nroff -rp7 -n39 -man.repro | col | lpr -Pip 

In this example, the -rp7 option for nroff initializes number register p to specify 
that this page is from Section 7 of the Reference Pages. The -n3 9 option specifies a 
starting page number of 39. The first page printed is numbered ‘7-39’. 


Files 


/usr/lib/tmac/tmac. an. repro The man. repro macro package file 

See Also 

col(l), man(l), nroff(l), tbl(l), man(7), man.nopage(7), catman(8) 
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Name 

me - macros for formatting papers 

Syntax 

nroff -me [ options ]file ... 

*roff -me [ options ]file ... 

Description 

This package of nroff and *rof f macro definitions provides a formatting facility 
for technical papers in various formats. When producing 2-column output on a 
terminal, filter the output through col(l). 

Many nroff and *roff requests are unsafe in conjunction with this package; 
however, these requests can be used with impunity after the first .pp: 

.bp Begin new page 

.br Break output line here 

.sp n Insert n spacing lines 

.Is n Line spacing: n=l single, n=2 double space 

.na No alignment of right margin 

.ce n Center next n lines 

.ul n Underline next n lines 

.sz +n Add n to point size 

Output of the eqn, neqn, refer, and tbl preprocessors for equations and tables is 
acceptable as input. 

Requests 

In the following list, “initialization” refers to the first .pp, .lp, .ip, .np, .sh, or .uh 
macro. This list is incomplete; see the -me Reference Manual, ULTRIX 
Supplementary Documents Vol. I: General User, for further details. 


Request 

Initial Cause Explanation 

Value Break 

.(b 

- 

yes 

Begin block. 

.(c 

- 

yes 

Begin centered block. 

.(d 

- 

no 

Begin delayed text. 

•(f 

- 

no 

Begin footnote. 

•d 

- 

yes 

Begin list. 

•(q 

- 

yes 

Begin major quote. 

.(x X 

- 

no 

Begin indexed item in 

.(z 

- 

no 

Begin floating keep. 

•)b 

- 

yes 

End block. 

.)c 

- 

yes 

End centered block. 

•)d 

- 

yes 

End delayed text. 

Of 

- 

yes 

End footnote. 

01 

- 

yes 

End list. 

0q 

- 

yes 

End major quote. 

Ox 

- 

yes 

End index item. 

0z 

- 

yes 

End floating keep. 
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.++ m H 


no 

Define paper section, m defines the part of the paper, and can be C 
(chapter), A (appendix), P (preliminary; for example, an abstract, table 
of contents, and so on), B (bibliography), RC (chapters renumbered 
from page one each chapter), or RA (appendix renumbered from page 
one). 

.+c T 

- 

yes 

Begin chapter (or appendix, etc., as set by .++). T is the chapter title. 

Ac 

1 

yes 

One-column format on a new page. 

.2c 

1 

yes 

Two-column format. 

.EN 

- 

yes 

Space after equation produced by eqn or neqn. 

.EQ x y 


yes 

Precede equation; break out and add space. Equation number is y. 

The optional argument x may be I to indent equation (default), L to 
left-adjust the equation, or C to center the equation. 

.TE 

- 

yes 

End table. 

.TH 

- 

yes 

End heading section of table. 

.TSx 

- 

yes 

Begin table; if x is H, table has repeated heading. 

.ac A N 

“ 

no 

Set up for ACM style output. A is the Author’s name(s), N is the total 
number of pages. Must be given before the first initialization. 

.b x 

no 

no 

Print x in boldface; if there is no argument, switch to boldface. 

.ba +n 

0 

yes 

Augments the base indent by n. This indent is used to set the indent on 
regular text (like paragraphs). 

.be 

no 

yes 

Begin new column. 

.bi x 

no 

no 

Print x in bold italics (nofill only). 

.bx x 

no 

no 

Print x in a box (nofill only). 

.ef 'x'y'z' 

//// 

no 

Set even footer to x y z. 

.eh 'x'y'z' 

//// 

no 

Set even header to x y z. 

.fo 'x'y'z' 


no 

Set footer to x y z. 

.hx 

- 

no 

Suppress headers and footers on next page. 

.he 'x'y'z' 

//// 

no 

Set header to x y z. 

.hi 

- 

yes 

Draw a horizontal line. 

.i x 

no 

no 

Italicize x; if x missing, italic text follows. 

.ipxy 

no 

yes 

Start indented paragraph, with hanging tag x. Indentation is y ens 
(default 5). 

•lp 

yes 

yes 

Start left-blocked paragraph. 

.lo 

“ 

no 

Read in a file of local macros of the form .*x. Must be given before 
initialization. 

.np 

1 

yes 

Start numbered paragraph. 

.of 'x'y'z' 

//// 

no 

Set odd footer to x y z. 

.oh 'x'y'z' 

✓ a s s 

no 

Set odd header to x y z. 

.pd 

- 

yes 

Print delayed text. 

•PP 

no 

yes 

Begin paragraph. First line indented. 

.r 

yes 

no 

Roman text follows. 

.re 

- 

no 

Reset tabs to default values. 

.sc 

no 

no 

Read in a file of special characters and diacritical marks. Must be 
given before initialization. 

.sh n x 

- 

yes 

Section head follows, font automatically bold, n is level of section, x 
is title of section. 

.sk 

no 

no 

Leave the next page blank. Only one page is remembered ahead. 

.sz +n 

lOp 

no 

Augment the point size by n points. 

.th 

no 

no 

Produce the paper in thesis format. Must be given before 
initialization. 

•tp 

no 

yes 

Begin title page. 
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.U X 

- 

no 

Underline argument (even in *roff). (Nofill only). 

.uh 

- 

yes 

Like .sh, but unnumbered. 

.xp X 

- 

no 

Print index x. 


Files 


/usr/lib/tmac/tmac.e 
/usr/lib/me/* 

See Also 

refer(l), tbl(l), nroff(l) 

-me Reference Manual, ULTRIX Supplementary Documents, Vol. I: General User 
Writing Papers with Nroff Using -me ULTRIX Supplementary Documents Vol. I: 
General User 


7-42 Macro Packages and Conventions 



ms (7) 


Name 

ms - text formatting macros 

Syntax 

nroff -ms [options] file ... 

*roff -ms [options] file ... 

Description 

This package of nroff and *rof f macro definitions provides a formatting facility 
for various styles of articles, theses, and books. When producing 2-column output on 
a terminal or lineprinter, or when reverse line motions are needed, filter the output 
through col(l). All external -ms macros are defined in the following section. 

Many nroff and *rof f requests are unsafe in conjunction with this package. 
However, the first four requests in the list that follows can be used with impunity 
after initialization, and the last two may be used even before initialization: 

.bp Begin new page 

.br Break output line 

.sp n Insert n spacing lines 

.ce n Center next n lines 

.Is n Line spacing: n=l single, n=2 double space 

.na No alignment of right margin 

Font and point size changes with Nf and Ns are also allowed; for example, NflwordNfR 
italicize word. Output of the tbl, *eqn, and refer(l) preprocessors for equations, 
tables, and references is acceptable as input. 

Requests 


Macro 

Name 

Initial 

Value 

Break? Explanation 

Reset? 

.AB x 

— 

y 

Begin abstract; if x =no, do not label abstract. 

.AE 

— 

y 

End abstract. 

.AI 

— 

y 

Author’s institution. 

.AM 

— 

n 

Better accent mark definitions. 

.AU 

— 

y 

Author’s name. 

.B x 

— 

n 

Embolden x ; if no x, switch to boldface. 

.B1 

- 

y 

Begin text to be enclosed in a box. 

.B2 

— 

y 

End boxed text and print it. 

.BT 

date 

n 

Bottom title, printed at foot of page. 

.BX x 

— 

n 

Print word x in a box. 

.CM 

if t 

n 

Cut mark between pages. 

.CT 

- 

y»y 

Chapter title: page number moved to CF (TM only). 

.DA x 

ifn 

n 

Force date x at bottom of page; today if no x . 

.DE 

- 

y 

End display (unfilled text) of any kind. 

.DS x y 

I 

y 

Begin display with keep; ;c=I,L,C,B; y =indent. 

.ID y 

8n,.5i 

y 

Indented display with no keep; y =indent. 

.LD 

- 

y 

Left display with no keep. 

.CD 

- 

y 

Centered display with no keep. 

.BD 

- 

y 

Block display; center entire block. 

.EFx 

- 

n 

Even page footer x (3 part, as for .tl). 


Macro Packages and Conventions 7-43 



ms(7) 


.EH x 

- 

n 

Even page header x (3 part, as for .tl). 

.EN 

- 

y 

End displayed equation produced by *eqn. 

.EQ* y 

- 

y 

Break out equation; x=L,I,C; y ^equation number. 

.FE 

- 

n 

End footnote to be placed at bottom of page. 

.FP 

- 

n 

Numbered footnote paragraph; may be redefined. 

.FS x 

- 

n 

Start footnote; x is optional footnote label. 

.HD 

undef 

n 

Optional page header below header margin. 

.1* 

_ 

n 

Italicize x ; if no x , switch to italics. 

.IP xy 

- 

y.y 

Indented paragraph, with hanging tag x; y =indent. 

.IX xy 

- 

y 

Index words x, y and so on (up to five levels). 

.KE 

- 

n 

End keep of any kind. 

.KF 

- 

n 

Begin floating keep; text fills remainder of page. 

.KS 

- 

y 

Begin keep; unit kept together on a single page. 

.LG 

- 

n 

Larger; increase point size by 2. 

.LP 

- 

y.y 

Left (block) paragraph.. 

.MC x 

- 

y.y 

Multiple columns; x=column width. 

.ND* 

if t 

n 

No date in page footer; x is date on cover. 

.NH*y 

- 

y.y 

Numbered header; x=level, x=0 resets, x=S sets to y. 

.NL 

lOp 

n 

Set point size back to normal. 

.OF x 

- 

n 

Odd page footer x (3 part, as for .tl). 

.OH x 

- 

n 

Odd page header x (3 part, as for .tl). 

.PI 

if TM 

n 

Print header on first page. 

.PP 

- 

y.y 

Paragraph with first line indented. 

.PT 

-%- 

n 

Page title, printed at head of page. 

.PX x 

- 

y 

Print index (table of contents); x=no, suppresses title. 

.QP 

- 

y.y 

Quote paragraph (indented and shorter). 

.R 

on 

n 

Return to Roman font. 

.RE 

5n 

y.y 

Retreat: end level of relative indentation. 

.RPx 

- 

n 

Released paper format; x=no, stops title on first page. 

.RS 

5n 

y.y 

Right shift: start level of relative indentation. 

.SH 

- 

y.y 

Section header, in boldface. 

.SM 

- 

n 

Smaller; decrease point size by two. 

.TA 

8n,5n 

n 

Set tabs to 8n 16n ... (nroff) 5n lOn ... (*roff). 

.TC x 

- 

y 

Print table of contents at end; x=no, suppresses title. 

.TE 

- 

y 

End of table processed by tbl. 

.TH 

- 

y 

End multipage header of table. 

.TL 

- 

y 

Title in boldface and two points larger. 

.TM 

off 

n 

UC Berkeley thesis mode. 

.TSx 

- 

y.y 

Begin table; if x =H, table has multipage header. 

.ULx 

- 

n 

Underline*, even in *roff. 

.UX x 

- 

n 

UNIX; trademark message first time; * appended. 

.XA xy 

_ 

y 

Another index entry; x=page or no for none; y =indent. 

.XE 

- 

y 

End index entry (or series of .IX entries). 

.XP 

- 

y.y 

Paragraph with first line exdented, others indented. 

.XS x y 

- 

y 

Begin index entry; * =page or no for none; y =indent. 

AC 

on 

y.y 

One-column format, on a new page. 

.2C 

- 

y.y 

Begin two-column format. 


- 

n 

Beginning of refer reference. 

.[0 

- 

n 

End of unclassifiable type of reference. 

•IN 

- 

n 

N= l:joumal-article, 2:book, 3:book-article, 4:report. 
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Registers 

Formatting distances can be controlled in -ms by means of built-in number registers. 
For example, this sets the line length to 6.5 inches: 

.nr LL 6.5i 

Here is a table of number registers and their default values: 


Name 

Register Controls Takes EffectDefault 

PS 

Point size 

paragraph 

10 

VS 

Vertical spacing 

paragraph 

12 

LL 

Line length 

paragraph 

6i 

LT 

Title length 

next page 

same as LL 

FL 

Footnote length 

next .FS 

5.5i 

PD 

Paragraph distance paragraph 

lv(ifn), .3v (ift) 

DD 

Display distance 

displays 

lv(ifn), .5v (ift) 

PI 

Paragraph indent 

paragraph 

5n 

Ql 

Quote indent 

next .QP 

5n 

FI 

Footnote indent 

next .FS 

2n 

PO 

Page offset 

next page 

0 (if n), ~li (if t) 

HM 

Header margin 

next page 

li 

FM 

Footer margin 

next page 

li 

FF 

Footnote format 

next .FS 

0 (1, 2, 3 available) 


When resetting these values, make sure to specify the appropriate units. Setting the 
line length to 7, for example, results in output with one character per line. Setting FF 
to 1 suppresses footnote superscripting; setting it to 2 also suppresses indentation of 
the first line; and setting it to 3 produces an .IP-like footnote paragraph. 

Here is a list of string registers available in -ms; they can be used anywhere in the 
text: 


Name 

String’s Function 

\*Q 

Quote (" in nr off, “ in *roff) 

\*U 

Unquote (" in nr off, ” in *roff) 

\*_ 

Dash (— in nroff, — in *roff) 

\*(MO 

Month (month of the year) 

\*(DY 

Day (current date) 

\** 

Automatically numbered footnote 

\*' 

Acute accent (before letter) 

\* v 

Grave accent (before letter) 

\*A 

Circumflex (before letter) 

V, 

Cedilla (before letter) 

\*: 

Umlaut (before letter) 

\* 

Tilde (before letter) 


When using the extended accent mark definitions available with .AM, these strings 
should come after, rather than before, the letter to be accented. 

Restrictions 

Floating keeps and regular keeps are diverted to the same space, so they cannot be 
mixed together with predictable results. 
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Files 


/usr/lib/tmac/tmac.s 
/usr/lib/ms/s.??? 

See Also 

refer(l), tbl(l) 
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Name 

term - conventional names for terminals 

Description 

Certain commands use these terminal names. They are maintained as part of the shell 
environment. For further information, see sh(l), and environ(7). 

adm3a Lear-Siegler ADM-3a 

2621 Hewlett-Packard HP262? series terminals 

hp Hewlett-Packard HP264? series terminals 

clOO Human Designed Systems Concept 100 

hl9 Heathkit H19 

mime Microterm mime in enhanced ACT IV mode 
1620 Diablo 1620 (and others using HyType II) 

300 DASI/DTC/GSI 300 (and others using HyType I) 

33 Teletype Model 33 

37 Teletype Model 37 

43 Teletype Model 43 

735 Texas Instruments TI735 (and TI725) 

745 Texas Instruments TI745 

dumb Terminals with no special features 

dialup A terminal on a phone line with no known characteristics 

network A terminal on a network connection with no known characteristics 

4014 Tektronix 4014 

vt52 Digital Equipment Corp. VT52 

vtlOO Digital Equipment Corp. VT100 

vt200 Digital Equipment Corp. VT200 - used on VT220, VT240 

vt300 Digital Equipment Corp. VT300 - used on VT330, VT340 

xterm xterm terminal emulator, X window system 

See /etc/termcap for an up-to-date and locally correct list. See termcap(5) for 
more information on /etc/termcap. 

Commands whose behavior may depend on the terminal, either consult TERM in the 
environment, or accept arguments of the form -Tterm, where term is one of the 
names given above. 

See Also 

clear(l), ex(l), plot(lg), more(l), sh(l), stty(l), tabs(l), nroff(l), tset(l), ul(l), 
termcap(3x), termcap(5), environ(7) 
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Index 


A 


H 


article 

formatting, 7-43 
ASCII character set 
map, 7—2t 
ascii keyword, 7-2 

B 


book 

formatting, 7-43 


hier keyword, 7-4, 7-9 
hierarchy 

root file system, 7-4, 7-9 
HOME string, 7-3 

I 

intro(7) keyword, 7-1 

M 


C 

CSNET site 

sending mail to, 7-15 

E 

environ global variable, 7-3 
environment 
strings, 7-3 
EXINIT string, 7-3 

F 

formatting 

article, 7-43 
book, 7-43 
thesis, 7-43 


mail 

abbreviating address, 7-14 
address protocol, 7-14 to 7-15 
ARP A protocol and, 7-15 
compatible addresses, 7-14 
routing, 7-15 
uucp and, 7-14 
mailaddr keyword, 7-14 
man macro package 

macros, 7-16 to 7-20, 7—16, 7-16 to 7-23 
man.nopage macro package 

macros, 7-24 to 7-28, 7-24 to 7-31 
man.repro macro package 
macros, 7-32 to 7-36, 7-32 
manual page 

formatting, 7-16, 7-24, 7-32 
me macro package, 7-40 
requests, 7-40t 
ms macro package 

floating keep restriction, 7-45 
number registers, 7-45, 7-43 
requests, 7-43t 
string registers, 7-45 




p 

PATH string, 7-3 
postmaster 
defined, 7-15 
PRINTER string, 7-3 

R 

root file system 

hierarchy, 7—4 to 7-5, 7-9 

s 

SHELL string, 7-3 

T 

technical paper 
formatting, 7-40 
term command, 7-47 
TERM string, 7-3 
TERMCAP string, 7-3 
terminal 

conventional names, 7-47t 
thesis 

formatting, 7-43 


u 

USER string, 7-3 
/usr file system 

hierarchy, 7-5 to 7-8, 7-10 
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How to Order Additional Documentation 


Technical Support 

If you need help deciding which documentation best meets your needs, call 800-343-4040 before placing 
your electronic, telephone, or direct mail order. 


Electronic Orders 

To place an order at the Electronic Store, dial 800-234-1998 using a 1200- or 2400-baud modem from 
anywhere in the USA, Canada, or Puerto Rico. If you need assistance using the Electronic Store, call 
800-DIGITAL (800-344-4825). 


Telephone and Direct Mail Orders 


Your Location 

Continental USA, 
Alaska, or Hawaii 

Puerto Rico 
Canada 


International 

* 

Internal 


Call 

800-DIGITAL 

809-754-7575 

800-267-6215 


Contact 

Digital Equipment Corporation 

P.O. Box CS2008 

Nashua, New Hampshire 03061 

Local Digital Subsidiary 

Digital Equipment of Canada 

Attn: DECdirect Operations KA02/2 

P.O. Box 13000 

100 Herzberg Road 

Kanata, Ontario, Canada K2K 2A6 

Local Digital subsidiary or 
approved distributor 

SSB Order Processing - WMO/E15 
or 

Software Supply Business 
Digital Equipment Corporation 
Westminster, Massachusetts 01473 


* For internal orders, you must submit an Internal Software Order Form (EN-01740-07). 
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problem and are eligible to receive one under Software Performance Report (SPR) service, submit your 
comments on an SPR form. 


Thank you for your assistance. 


Please rate this manual: 

Excellent 

Good 

Fair 

Poor 

Accuracy (software works as manual says) 

□ 

□ 

□ 

□ 

Completeness (enough information) 

□ 

□ 

□ 

□ 

Clarity (easy to understand) 

□ 

□ 

□ 

□ 

Organization (structure of subject matter) 

□ 

□ 

□ 

□ 

Figures (useful) 

□ 

□ 

□ 

□ 

Examples (useful) 

□ 

□ 

□ 

□ 

Index (ability to find topic) 

□ 

□ 

□ 

□ 

Page layout (easy to find information) 

□ 

□ 

□ 

□ 


What would you like to see more/less of? 


What do you like best about this manual? 


What do you like least about this manual? 


Please list errors you have found in this manual: 
Page Description 


Additional comments or suggestions to improve this manual: 


What version of the software described by this manual are you using? _ 

Name/Title _ Dept. _ 

Company _ Date 

Mailing Address _ 

_ Email _ Phone _ 
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